home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / c / pc_shell / doku / pc_shell.txt < prev   
Encoding:
Text File  |  1995-11-25  |  18.3 KB  |  392 lines
  1. ****************************************************************************
  2. *****              Anleitung für die PureC-Shell 3.00                  *****
  3. ****************************************************************************
  4.  
  5.  
  6. Programmiert in PureC von:        Frank Schramm
  7.                                   Kasperstr.5
  8.                                   D-21647 Moisburg
  9.                                   Tel.: 04165/6173
  10.                                   E-Mail: Frank Schramm @ HH2
  11.  
  12.                                   Bankverbindung: StSpk Buxtehude
  13.                                                   BLZ 241 520 80
  14.                                                   Kto: 876235
  15.  
  16.   PureC-Shell ist Shareware. Die Benutzung von PureC-Shell 2.25
  17.   kostet 20.- DM (Bar, Scheck oder Überweisung) an oben genannte Adresse.
  18.   Registrierte Benutzer können jederzeit, durch zusenden einer
  19.   formatierten Diskette und einem frankiertem Rückumschlag, die neueste
  20.   Version bei mir bekommen.
  21.   
  22.   Ab der Version 2.19 ist die PC-Shell leicht eingeschränkt, bei der
  23.   unregistrierten Version erscheint vor dem Compilieren eine Dialogbox,
  24.   die auf den Shareware-Status hinweist.
  25.   Die Registrierung erfolgt durch einen persönlichen Schlüssel.
  26.  
  27.   Wichtig ist bei Überweisungen, das die komplette Anschrift angegeben
  28.   wird, ggf. auch die Telefonnummer oder E-Mail-Anschrift(Mausnetz).
  29.   Der Registrierungs-Schlüssel wird nach erfolgter Bezahlung, nach Wunsch
  30.   telefonisch, per Brief oder per E-Mail(Mausnetz) mitgeteilt.
  31.  
  32.   PureC-Shell besteht aus folgenden Dateien:
  33.  
  34.        PC_SHELL.APP        PureC-Shell
  35.        PC_SHELL.AM         Modul zum bearbeiten von Unterprojekten, wird erst bei Bedarf
  36.                            nachgeladen. Bei Änderung des Modulnamens auf PC_SHELL.AMA
  37.                            wird das Modul beim Start der PC-SHELL gleich mitgeladen.
  38.        PARALLEL.TTP        Zum Compilieren im Hintergrund mit MagiX und MTOS.
  39.                            (muß im gleichen Verzeichnis sein, wie PC_SHELL.APP)
  40.                            Das VT52.PRG (nur MagiX) muß installiert sein.
  41.        PC_SHELL.TXT        dieser Text
  42.        CHANGES.TXT         Änderungen
  43.        PC_HYP              ST-Guide Hypertext von Manfred Rosenboom.
  44.  
  45.   Die PureC-Shell legt während der Laufzeit folgende Dateien an:
  46.                 
  47.        ERROR.DAT           Datei für die Fehlermeldungen. Befindet sich im Source-Pfad.
  48.        PARALLEL.INF        INF-Datei für das PARALLEL.TTP. Befindet sich im Source-Pfad.
  49.        PCLINK.CFG          Zur Übergabe von Parametern an den Linker
  50.        bzw. PCC.CFG        bzw. Compiler.
  51.  
  52.   PureC-Shell läuft auf TOS-Versionen >=1.04 /Multitos/MagiX! und einer Mindestauflösung
  53.               mit 640 Pixeln Breite und 400 Pixeln Höhe.
  54.  
  55.   Hardware:   ST/STE/TT/Falcon030.
  56.  
  57. *************************** Menüpunkte *************************************
  58.  
  59.  Datei:
  60. ********
  61.  
  62.      PC Neu...         Neues Projekt öffnen. Mit dem Fileselektor wird der
  63.                        Name der Projektdatei (*.PC) angegeben. Die Projektdatei
  64.                        muss sich im gleichen Verzeichnis befinden wie die
  65.                        Sourcedateien.
  66.  
  67.      PC Öffnen...      Öffnet eine schon vorhandene Projektdatei (*.PC).
  68.  
  69.      PC Sichern...     Sichert die geöffnete Projektdatei.
  70.  
  71.      PC Sichern als... Sichert die geöffnete Projektdatei, wobei ein anderer
  72.                        Projektname eingegeben werden kann.
  73.  
  74.      PRJ öffnen..      Öffnet eine original PureC-Projektdatei (*.PRJ).
  75.  
  76.      PRJ sichern..     Sichert die geöffnete Projektdatei als
  77.                        PureC-Projektdatei (*.PRJ).
  78.  
  79.      beenden...        Programmende
  80.  
  81.  
  82.  Editor:
  83. *********
  84.  
  85.      *.C editieren...   *.C Datei editieren.
  86.  
  87.      *.S editieren...   *.S Datei editieren.
  88.  
  89.      *.H editieren...   *.H Datei editieren.
  90.  
  91.      *.* editieren...   *.* Datei editieren.
  92.  
  93.      Projekt-Suche...   Durchsucht alle im Projekt angegebenen Source-
  94.                         und Abhängigkeitsdateien nach einer Zeichenkette.
  95.                         (Abbruch durch LinksSHIFT + RechtsSHIFT)
  96.                         Die gefundenen Textstellen werden in einem Fenster
  97.                         ausgegeben, und zwar in der Form:
  98.                           - Datei-Name, Zeile, Inhalt der Zeile.
  99.                         Durch Klick auf diese Zeile wird die Datei
  100.                         in den internen Editor geladen, und der Cursor
  101.                         auf die betreffende Textstelle gesetzt.
  102.  
  103.  Compiler:
  104. ***********
  105.  
  106.      Compilieren...   Compiliert eine mit dem Fileselektor
  107.                       ausgewählte Datei.
  108.  
  109.      Assemblieren...  Assembliert eine mit dem Fileselektor
  110.                       ausgewählte Datei.
  111.  
  112.      Make             Erzeugt, aus den im Projektfenster angegebenen Source-
  113.                       und Library-Dateien, die unter 'Programm-Name'
  114.                       angegebene Datei.
  115.                       Es werden nur die geänderten Sourcedateien
  116.                       compiliert bzw. assembliert.
  117.                       Ob Dateien verändert wurden, wird am Datum und Zeit
  118.                       der Datei festgestellt. Deshalb ist es wichtig, das die
  119.                       Rechneruhr die aktuelle Uhrzeit und Datum enthält.
  120.  
  121.      Make All         Erzeugt, aus den im Projektfenster angegebenen Source-
  122.                       und Library-Dateien, die unter 'Programm-Name'
  123.                       angegebene Datei.
  124.                       Es werden alle Sourcedateien neu compiliert bzw.
  125.                       assembliert.
  126.  
  127.                       Die Projekterzeugung kann durch längeres drücken
  128.                       der beiden SHIFT-Taste abgebrochen werden.
  129.  
  130.      Linken           Linkt das Projekt.
  131.  
  132.      Prg. debuggen    Übergibt das vom Projekt erzeugte Programm an
  133.                       den Pure-Debugger.
  134.  
  135.      Prg. profilen    Übergibt das vom Projekt erzeugte Programm an
  136.                       den Pure-Profiler (falls vorhanden). 
  137.                       Das PROFILER.PRG muß sich im PureC-Pfad befinden. 
  138.                       Die Profiler HLP-Dateien sollten dann in einem 
  139.                       Unterverzeichnis liegen. Der Pfad kann in den 
  140.                       Profiler-Optionen eingestellt werden.
  141.                       (Nicht unter Multitos)
  142.  
  143.      Prg. starten     Startet das vom Projekt erzeugte Programm.
  144.                       Hat der Prg.-Name die Endung '.AM' wird das
  145.                       Programm als Modul gestartet.
  146.  
  147.  
  148.  Optionen:
  149. ***********
  150.  
  151.      Compiler...      Einstellen der Compiler-Optionen.
  152.  
  153.      Assembler...     Einstellen der Assembler-Optionen.
  154.  
  155.      Linker...        Einstellen der Linker-Optionen.
  156.      
  157.      DEF sichern      Default-Einstellungen sichern von:
  158.                           -Compiler-, Assembler- und Linker-Optionen
  159.                             (Die Include und Lib-Directorys werden nur in
  160.                              der INF-Datei gesichert)
  161.                           -Library-Dateien
  162.                           -Pfad für den Prg-Namen
  163.                       Die Defaulteinstellungen werden nur beim erstellen einer
  164.                       neuen *.PC-Datei (PC neu...) verwendet. 
  165.  
  166.      Pfade...         Einstellen der Pfade:
  167.                       - Editor1 + Editor2
  168.                       - Parameter für Editor1 + Editor2
  169.                       - RCS (Resource-Editor)
  170.                       - PureC (In diesem Verzeichnis müssen sich die
  171.                                PureC-Programme befinden: PD.PRG, PASM.TTP,
  172.                                PCC.TTP und PLINK.TTP)
  173.                       - Pfad des PC_HELP.PRG
  174.  
  175.      Programme...     Auswählen von Programmen die über die Funktionstasten
  176.                       F1-F10 gestartet werden können.
  177.  
  178.      Source-Liste...  Zusätzliche Source-Editoren mit konfigurierbaren
  179.                       Datei-Extendern. Ist z.B. das ACS.PRG für den Datei-
  180.                       Extender *.ACS eingetragen, wird für das editieren
  181.                       einer *.ACS Datei das ACS.PRG geladen.  
  182.  
  183.      INF sichern...   Sichern der PC_SHELL.INF Datei, sie enthält:
  184.                        - Die in 'Pfade...', 'Programme...' und 'Diverse...'
  185.                              vorgenommenen Einstellungen.
  186.                        - Die in (Optionen) 'Compiler...', 'Assembler...'
  187.                              und 'Linker...' angegebenen Include- und Library-Directory.
  188.                        - Die Position und Größe der einzelnen Fenster.
  189.                        - Alle geöffneten Fenster.
  190.                        - Die geladene Projektdatei.
  191.                        - Den Registrierschlüssel.
  192.  
  193.      INF laden...     Laden einer INF-Datei.
  194.  
  195.  
  196.  Extras:
  197. *********
  198.  
  199.      Resource...      Auswahl einer Resource-Datei und starten des
  200.                       Resource-Editors.
  201.  
  202.      Debugger...      Auswahl eines Programms und starten des
  203.                       PureC-Debuggers.
  204.  
  205.      Profiler...      Auswahl eines Programms und starten des
  206.                       Pure-Profilers (falls vorhanden). Das PROFILER.PRG muß sich
  207.                       im PureC-Pfad befinden. Die Profiler HLP-Dateien
  208.                       sollten dann in einem Unterverzeichnis liegen.
  209.                       Der Pfad kann in den Profiler-Optionen eingestellt werden.
  210.                       (Nicht unter Multitos)
  211.  
  212.      Modul laden...   Laden von ACS-Modulen. Die Module müßen 
  213.                       ACS >=2.20 compiliert sein.
  214.  
  215.      Diverse...       Einstellungen:
  216.                       - verschiedene Schalter
  217.                            (Grow- und Shrink, Pulldown-Menüs,
  218.                             PC_HELP.PRG verwenden usw.)
  219.                       - festlegen des Editors der verwendet werden soll.
  220.                       - angeben welcher Editor das ARGV-Protokoll beherrscht,
  221.                            wie z.B. EVEREST oder QED.
  222.                            (wichtig für 'Edit', da mit dem ARGV-
  223.                             Protokoll eine beliebig lange Kommandozeile
  224.                             übergeben werden kann.)
  225.                       - Endung der Resource-Dateien.
  226.                              (wird für 'Resource...' verwendet)
  227.  
  228.      Desktop-Farbe... Auswahl der Desktopfarbe, ab einer Auflösung >= 16 Farben.
  229.                       (nur Single-TOS)
  230.  
  231.      Fehlermeldungen  Öffnet das Fehlermeldungen-Fenster.
  232.      
  233.      Source-Inhalt    öffnet ein Fenster, in dem die Hilfstexte der 
  234.                       Source-Dateien ausgegeben werden. Durch Mausklick auf den
  235.                       Dateinamen, wird die Datei in den Editor geladen.
  236.  
  237.      Fenster          Aktuelles Fenster wechseln.
  238.      
  239.      Fenster-Popup    Popup zum toppen eines PC_SHELL Fensters.
  240.  
  241.      PRG starten...   Starten eines beliebigen Programms, das über den
  242.                       Fileselektor ausgewählt wird.
  243.  
  244.  
  245.  Hilfe:
  246. ********
  247.  
  248.      PC-Shell...      ST-Guide Hilfe aufrufen.
  249.  
  250.      Menü...          ST-Guide Hilfe aufrufen.
  251.  
  252.      Editor...        ST-Guide Hilfe aufrufen.
  253.  
  254.      Index...         ST-Guide Hilfe aufrufen.
  255.  
  256. ****************************************************************************
  257.  
  258.  Projekt-Fenster:
  259. ******************
  260.  
  261.       Das Projekt-Fenster besteht aus zwei Listboxen, jeweils
  262.       einer für Source-Dateien (max. 500) und einer für Library-Dateien (max. 100).
  263.       Auswahl und Bearbeiten der Source- und Library-Dateien durch Drag&Drop.
  264.       Für die Bedienung der Abhängigkeiten-Listbox gilt das unten beschriebene auch.
  265.  
  266.       Prg.-Name Dialog: -Name des zu compilierenden Programms bzw. Objektdatei.
  267.                         -ggf. Programm-Pfad
  268.                         -ggf. Kommandozeile (wird bei 'Prg. starten' übergeben).
  269.                         
  270.  
  271.       Icone:
  272.      ********  
  273.  
  274.          Source neu:   Auswählen von Source-Dateien (Selectric wird unterstützt).
  275.  
  276.          Library neu:  Auswählen von Library-Dateien (Selectric wird unterstützt).
  277.          
  278.          Klemmbrett:   - speichern  =Ziehen von Source- oder/und Library-Dateien auf das Klemmbrett.
  279.                        - laden      =Ziehen des Klemmbrettes in die Source- oder Library-Listbox
  280.  
  281.          Mülleimer:    Löschen      =Ziehen von Source- oder/und Library-Dateien auf den Mülleimer.
  282.  
  283.          Edit:         Editieren    =Ziehen von Source-Dateien auf das Edit-Icon, oder
  284.                                      Source-Dateien selektieren und Klick auf das
  285.                                      Editor-Icon.
  286.                                      Durch Doppelklick auf eine Source-Datei, wird diese
  287.                                      in den Editor geladen.
  288.          
  289.          Arbeit:       Compilieren/Assemblieren  =Ziehen von Source-Dateien auf das Arbeit-Icon, oder
  290.                                      Source-Dateien selektieren und Klick auf das
  291.                                      Arbeit-Icon.
  292.          
  293.          Option:       Abhängigkeiten, lokale Compiler- bzw. Assembleroptionen und
  294.                                      Hilfstexte (Source-Inhalt) einstellen.
  295.                        Hilfstexte:   Maximale Größe je Hilfstext ist 32KBytes.
  296.                                      Die Hilfstexte werden nur im *.PC Projekt gespeichert,
  297.                                      und nicht im *.PRJ Projekt. 
  298.                                      Clipboard-Unterstützung (^C, ^X, ^V, ^Y)
  299.                                      
  300.                        Source-Compiler: Für alle Dateien in der Source-Liste (ausgenommen sind *.C und *.S)
  301.                                      kann ein Source-Compiler (nur *.TOS oder *.TTP) angegeben werden.
  302.                                      Dieses Programm wird gestartet (Make, Make All und Icon 'Arbeit')
  303.                                      wenn die Sourcedatei ein neueres Datum hat, als die unter
  304.                                      'Zeitverbleich mit:' angegebene Datei. Damit diese Programm verwendet wird,
  305.                                      muß der Schalter 'Source-Compiler benutzen' eingeschaltet sein.
  306.                                      Der Button 'Source' bewirkt, das der Name der Sourcedatei an
  307.                                      die Kommandozeile angehängt wird. 
  308.                                      Vor Aufruf des Source-Compilers wird der aktuelle Projekt-Pfad
  309.                                      gesetzt, sodas nur der Name der Sourcedatei übergeben werden muß.
  310.  
  311.                                     =Ziehen von Source-Dateien auf das Option-Icon, oder
  312.                                      Source-Dateien selektieren und Klick auf das
  313.                                      Option-Icon.
  314.  
  315.       Tastaturbedienung:
  316.      ********************
  317.      
  318.          Source neu  (ALT-S)
  319.          Library neu (ALT-L)
  320.          Klemmbrett  (speichern = ^C, laden ^V) nur selektierte Einträge werden bearbeitet.
  321.          Mülleimer   (^D)                       nur selektierte Einträge werden bearbeitet.
  322.          Edit        (^E)                       nur selektierte Einträge werden bearbeitet.
  323.          Arbeit      (^B)                       nur selektierte Einträge werden bearbeitet.
  324.          Option      (^I)                       nur selektierte Einträge werden bearbeitet.
  325.          
  326.          Cursor:     Cursor anschalten (Cursor - Up, Down, Left oder Right)
  327.                      Cursor nach oben  (Cursor Up) mit SHIFT seitenweise.
  328.                      Cursor nach unten (Cursor Down)  mit SHIFT seitenweise.
  329.                      Listbox wechseln  (Cursor Right bzw. Left)
  330.                      Alle Einträge in der Listbox, in der sich der Cursor befindet, selektieren.  (^A)
  331.                      Eintrag unter dem Cursor selektieren.    (INSERT) selektieren mehrerer Einträge mit
  332.                                                                        Hilfe der SHIFT-Taste.
  333.                      Einträge deselektieren.                  (DELETE) deselektieren nur eines Eintrages
  334.                                                                        mit Hilfe der Shift-Taste
  335.  
  336.       Die Source-Dateien werden bei der Projekterstellung ('Make' oder 'Make All')
  337.       folgendermaßen bearbeitet:
  338.          - *.C   Dateien werden compiliert.
  339.          - *.S   Dateien werden assembliert.
  340.          - *.O   und *.LIB Dateien werden hinzugelinkt.
  341.          - *.PC  Das Projekt wird erstellt.
  342.          - *.PRJ Das Projekt wird erstellt.
  343.       alle anderen Dateien werden ignoriert.
  344.       So kann man z.B. auch Headerdateien (*.H) mit in die Source-Dateien-Liste
  345.       übernehmen, um sie zum editieren nicht suchen zu müssen.
  346.       
  347.     * Wenn die Reihenfolge der Dateien wichtig ist, können einfach alle
  348.     * Dateien (inkl. LIB's) in die Source-Liste (in der gewünschten Reihenfolge)
  349.     * eingetragen werden.
  350.     * Die Library-Liste bleibt dann leer.
  351.  
  352.       Die Library-Dateien müssen sich im Library-Directory befinden.
  353.       (siehe `Linker...')
  354.  
  355. ****************************************************************************
  356.  
  357.  Fehlermeldungen-Fenster:
  358. **************************
  359.  
  360.             Die bei der Projekterstellung anfallenden Fehlermeldungen
  361.             werden in die Datei ERROR.DAT umgeleitet.
  362.             Ist die Projekterstellung beendet, wird der Inhalt der Datei
  363.             in einem Fenster angezeigt. Durch einen Einfachklick auf eine
  364.             Fehlermeldung (ERROR oder WARNING), wird bei eingeschalteten
  365.             internen Editor, die Source-Datei geladen und der Cursor
  366.             befindet sich in der Zeile auf die sich die Fehlermeldung
  367.             bezieht. Bei eingeschalteten externen Editor, wird die
  368.             Source-Datei und die ERROR.DAT Datei an den Editor übergeben.
  369.             Bei manchen Editoren, wie z.B. EVEREST, ist es jetzt auch
  370.             möglich, das der Editor, durch Doppelklick auf eine Fehlermeldung,
  371.             den Cursor in die dazugehörige Zeile der Sourcedatei setzt.
  372.             
  373.             Durch betätigen der HELP-Taste, wird die PureC-Hilfe für
  374.             Fehlermeldungen aufgerufen.
  375.  
  376. ****************************************************************************
  377.  
  378.   ***Pure C ist eingetragenes Warenzeichen der Firma Pure Software GmbH.***
  379.  
  380. HAFTUNGSAUSSCHLUSS
  381. ------------------
  382.  
  383.   Das Programm  wurden ausführlich getestet.  Für etwaige  Schäden, die
  384.   durch die Verwendung von PureC-Shell entstehen, kann
  385.   ich keine Haftung übernehmen.
  386.  
  387.   Sollten Sie  trotzdem einen Fehler feststellen  oder Verbesserungsvor-
  388.   schläge haben, so können sie mich unter der oben angegebenen Anschrift
  389.   oder per E-Mail erreichen.
  390.  
  391.  
  392.